[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 KBDSTUFF SEXP

 Function
  Stuff a string into the keyboard buffer for later processing.

 Syntax
  KBDSTUFF str

   str  - A string expression to stuff into the keyboard buffer for
          later processing.

 Remarks
  This statement allows you to feed a series of keystrokes to PCBoard as
  though they were typed in by the user.  This can be especially useful
  when you are replacing an existing command; add your PPE file to the
  CMD.LST file so that it takes the place of the built in command, then
  have your PPE stuff the original (or modified command) back to the
  keyboard buffer.

  PCBoard will then process it as soon as you exit your PPE application.
  It can also be used when building new commands that should perform several
  built in operations automatically.  A maximum of 256 characters at a time
  can be stuffed into the keyboard buffer.  If you need more than this, you
  should use KBDFILE.

  Please note that if you need to stuff carrage returns between commands
  that you must use ^M and NOT CHR(13).  Also, only one KBDSTUFF will work
  per PPE call.  That is, you can NOT use the structure:
       .
       .
       KBDSTUFF "J"
       KBDSTUFF "1"
       KBDSTUFF "F"
       .
       .
  Instead, save them to a string variable and stuff them all at once:

       cmd_string="....J;1;F...."
       KBDSTUFF cmd_string

 Examples
  INTEGER retcode
  SHOWOFF
  OPENCAP "NEWFILES.LST",retcode
  KBDSTUFF CHR(13)
  DIR "N;S;A;NS"
  CLOSECAP
  SHOWON
  SHELL TRUE,retcode,"PKZIP","-mex NEWFILES NEWFILES.LST"
  KBDSTUFF "FLAG NEWFILES.ZIP"

See Also: KBDFILE
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson